home *** CD-ROM | disk | FTP | other *** search
/ Megarom / Megarom Macintosh CD Software (Quantum Leap)(1992).iso / COMPRESS / IBM Uncompactors / ArcMac2.Doc < prev    next >
Text File  |  1988-02-08  |  32KB  |  1,066 lines
  1.  
  2.  
  3.       easy processing.  The most fundamental is the space character.  A 
  4.       name is always considered to be one word, and words cannot have 
  5.       spaces.  A command or list of names is several words delimited by 
  6.       spaces.  MOS handles spaces in file names that it reads by 
  7.       interpreting them as the required space (ascii $CA).  When you 
  8.       want to specify a file whose name contains a space, you can use 
  9.       the keyboard required space (option-space bar) or often you can 
  10.       substitute a "?" wild card.  
  11.  
  12.       You can use the "?" to match any single letter where wild cards 
  13.       are allowed, or "*" to match a bunch of letters at the start or 
  14.       end of a name.  Upper case and lower case letters are not 
  15.       distinguished.
  16.  
  17.               Special file name characters
  18.  
  19.               ?       match 1 letter in file name
  20.               *       match many letters in file name
  21.               :       drive and path name separator
  22.               \       path name separator
  23.               ..      (two periods), parent directory specifier
  24.               /       command line option character (some commands)
  25.               
  26.  
  27.       Control Keys
  28.       ------------
  29.  
  30.       Two standard control keys are active during all operations.  
  31.  
  32.               ^C = user break
  33.               ^S = stop list
  34.  
  35.       The Stop List key (control-S) causes all display listing to pause 
  36.       until you press control-S again.  
  37.  
  38.       The User Break key (control-C, also the "enter" key on many 
  39.       Macintosh keyboards) will halt the current operation and return 
  40.       you to the main MOS prompt.  If typed at the main MOS prompt, MOS 
  41.       halts (equivalent to EXIT).
  42.  
  43.  
  44.       Mouse Clicks
  45.       ------------
  46.  
  47.               click on word = type it
  48.               click on © = carriage return
  49.  
  50.       ArcMac supports mouse operations in two ways.  First, there is an 
  51.       Arc Dialog under the "Mouse" menu.  This dialog contains 
  52.       essentially all of the archiving operations in a mouse clickable 
  53.       format of buttons and standard file dialogs. 
  54.  
  55.       The other support for mouse clicks is to make any displayed words 
  56.       clickable as though they were typed from the keyboard.  You can 
  57.       select file names for operations in this manner by displaying a 
  58.  
  59.  
  60.        ArcMac  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  16
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.       directory then clicking on listed names.  The special circle c 
  70.       symbol (copyright symbol) displayed at the MOS prompt is a 
  71.       carriage return when clicked on.
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.        ArcMac  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  17
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.       Archiver Commands
  138.       -----------------
  139.  
  140.       ARC  command[modifiers]  archive  [filename ...]
  141.  
  142.                Commands                   Modifiers
  143.  
  144.         L = List archived files     B = retain Backup of archive
  145.         V = Verbose list of files   I = strip IBM text controls (extract)
  146.         A = Add files to archive    S = Store only (no compression, add)
  147.         F = Freshen archive         Q = Quick crunch (no analysis, add)
  148.         U = Update archive          H = Huffman squeeze (no analysis,add)
  149.       E,X = EXtract archive files   G<password>                          
  150.         P = Print archived files      = Garble/unGarble archived files   
  151.         D = Delete archived files   W = no Warning messages              
  152.         M = Move files to archive   N = no Notes & comments              
  153.         T = Test archive integrity
  154.         C = Convert entry to new packing
  155.  
  156.       This is the archiver command line, consisting of two or more 
  157.       words:
  158.  
  159.       (1) the command character plus any modifiers as one word. If the 
  160.       garble modifier is used, it must be the last option and followed 
  161.       immediately by the password, with no spaces.
  162.  
  163.       (2) the name of the archive to operate on. 
  164.  
  165.       (3+) a list of file names to operate with. The file names can 
  166.       contain wild cards ("*" and "?") and path specifications.
  167.  
  168.  
  169.  
  170.       A, Add files to an archive
  171.  
  172.       Create a new archive, or add files to an existing archive, with 
  173.       the A command.  Follow the command with any desired options.  
  174.       Next, name the archive to work on, and follow this with a list of 
  175.       files to add.  If no file list is given, all files in the current 
  176.       directory will be added to the archive.
  177.  
  178.       Some examples of the use of Add would look like:
  179.  
  180.               arc a myarc *           
  181.               -- add all files in current directory to archive 
  182.       "myarc.arc"
  183.  
  184.               arc a h:jake:docs  h:words:*.text  h:progs:*.docs
  185.               -- add files ending with ".text" in directory "h:words:" 
  186.       and files ending with ".docs" in directory "h:progs:" to archive 
  187.       "docs.arc" in directory "h:jake:"
  188.  
  189.  
  190.  
  191.  
  192.  
  193.        ArcMac  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  18
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.       Modifiers for the Add commands
  203.  
  204.       B, retain backup copy of original archive.
  205.  
  206.       S, store only (no compression).
  207.  
  208.       Q, quick crunch only (no analysis).  This is useful if your files 
  209.            are all text (which almost always end up crunching), since 
  210.            it is faster than full analysis.
  211.  
  212.       H, huffman squeeze only (no analysis).  Picture files usually 
  213.            are optimally compressed with the Huffman squeeze method. 
  214.            This option will save time if want to use squeezing only on 
  215.            your files.
  216.  
  217.       You can use the Q+H modifiers together to produce archive entries 
  218.       that are compatible with the SEA ARC standard.  Using Q+H with 
  219.       any of the adding commands, or with Convert, will prevent 
  220.       the Squashing method of PKArc, which SEA's ARC cannot handle.
  221.  
  222.       Gpassword, use a password to encrypt the added files.  The 
  223.            G modifier must be the last in the command word, and it's 
  224.            password must immediately follow, with no space. The 
  225.            password can be any word of your choosing.  Upper and lower 
  226.            case letters are not distinguished.
  227.  
  228.       W, suppress warning messages to the console.
  229.  
  230.       N, suppress note and comment messages to the console.
  231.  
  232.       For example,
  233.  
  234.               arc abs bob jake:*
  235.               -- adds to archive bob.arc, retaining old version of 
  236.       archive as bob.bak, and stores files from jake without 
  237.       compression.
  238.  
  239.               arc agMyPassword  bob jake:*
  240.               -- adds to the archive using the garble (encryption) 
  241.       password "MyPassword".  All passwords are converted to uppercase, 
  242.       so you can type in upper and/or lowercase passwords for the same 
  243.       effect.  
  244.  
  245.       When extracting this archive, you will need to supply the same 
  246.       password, as in
  247.  
  248.               arc xgMyPassword bob
  249.  
  250.  
  251.       U, Updating archives       
  252.  
  253.       This command also will add files to an archive, but it will only 
  254.       add files that are newer than the current contents of the 
  255.       archive, or that do not exist in the archive.  The same modifiers 
  256.       for Add are active with Update.  Use this command to maintain the 
  257.  
  258.  
  259.        ArcMac  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  19
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.       most recent contents of folders in an archive.  For example,
  269.  
  270.               arc u data data:* 
  271.               -- this command will replace old versions of files in the 
  272.       "data.arc" archive with newer versions in the folder "data:", 
  273.       adding any files that don't exist in the archive.
  274.  
  275.  
  276.       F, Freshening archives
  277.  
  278.       This is a third variant of adding files, similar to Update, 
  279.       except that no new files are added.  Freshen only adds newer 
  280.       versions of files that exist in an archive, and ignores files 
  281.       from the folder that are not already in the archive.
  282.  
  283.               arc f data  h:tests:*  h:ralphs:data:*
  284.               -- this command updates the current contents of 
  285.       "data.arc" from the folders "ralphs:data:" and "tests:".
  286.  
  287.        
  288.       M, Move files to archive
  289.  
  290.       This final version of adding files acts like the Add command but 
  291.       also erases the file after adding it to the archive.  Erased 
  292.       files are immediately removed from the disk after archiving, they 
  293.       are not placed in the Trash folder. 
  294.  
  295.               arc m data  data:*
  296.               -- adds all files in the folder "data:" to the archive 
  297.       "data.arc", and erases each file as it is added.
  298.  
  299.  
  300.       L, List archived files
  301.  
  302.       This command lists the name, type, date, and original size of 
  303.       each file in an archive.  If no file list is given, all files are 
  304.       listed.  Otherwise only those matching the file list are listed.  
  305.       The file type is the Macintosh system file type, or if the 
  306.       archive was produced by IBM/MS-DOS archivers, the type is listed 
  307.       as "ibm".  
  308.  
  309.               arc l bob *.text
  310.               -- list all files in archive "bob.arc" that end with 
  311.       ".text", produces this output 
  312.  
  313.             Name          Kind  Length   Date
  314.             ------------  ----  -------  --------- 
  315.             rf1.text      TEXT    33796   1 Dec 87
  316.             rf1stat.text  TEXT    29408  30 Nov 87
  317.             uplot3f.text  TEXT    25989   1 Dec 87
  318.             ------------        -------
  319.             Total      3          89193  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.        ArcMac  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  20
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.       V, Verbosely list files in an archive
  335.  
  336.       This command lists all information on the archived files.  As 
  337.       well as the information of the List command, it displays the 
  338.       method of archiving, the archived size, percent of packing 
  339.       reduction, the file time, and the storage CRC value.  
  340.  
  341.               arc v doc *.text
  342.               
  343.               -- produces this verbose listing
  344.  
  345.       Name         Kind Length  Stowage  ArcSize  %   Date      Time   CRC
  346.       ------------ ---- ------- -------- ------- ---- --------- ------ ----
  347.       rf1.text     TEXT   33796 Crunched   16473  52   1 Dec 87  3:23a 823F
  348.       rf1stat.text TEXT   29408 Crunched   15001  49  30 Nov 87  3:33p 49E0
  349.       uplot3f.text TEXT   25989 Crunched   13320  49   1 Dec 87  3:40a E272
  350.       ------------       ------          ------- ----
  351.       Total      3        89193            44794  50%  
  352.  
  353.       The methods of stowage that ArcMac supports are
  354.               
  355.            Stored    stored without packing
  356.            Packed    packed with non-repeat encoding
  357.            Squeezed  packed with Huffman encoding
  358.            crunched  packed with old-style Lempel-Ziv compression
  359.            Crunched  packed with dynamic Lempel-Ziv compression
  360.            Squashed  packed with Phil Katz style dynamic Lempel-Ziv 
  361.                      compression.
  362.  
  363.       *** Note: ArcMac version 1.1 introduces full archive/dearchive 
  364.       support for the popular Squash method as produced by the PKARC 
  365.       program of Phil Katz.  
  366.  
  367.       The percent reduction is the percentage by which each file is 
  368.       reduced in size by packing.  The date and time are for the last 
  369.       file modification, and the CRC (Cyclic Redundancy Check) value is 
  370.       a check value for testing file integrity.  If two files have the 
  371.       same CRC value, they will, with high probability, contain the 
  372.       same data, regardless of their dates or name.
  373.  
  374.  
  375.       D, Delete files from archive
  376.  
  377.       The delete command removes files from an archive.  For example
  378.  
  379.               arc d dogs cat*.*
  380.               -- removes all files starting with "cat" from the archive 
  381.       "dogs.arc".
  382.  
  383.  
  384.       E,X  Extract files from an archive
  385.  
  386.       Files are unpacked and extracted from an archive using the E or X 
  387.       command.  You can specify a file list, and include the names of 
  388.       target folders for the extracted files:
  389.  
  390.  
  391.        ArcMac  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  21
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.               arc x dogs  cat*.*
  402.               -- extract all files whose names begin with "cat" from 
  403.       the archive "dogs.arc".
  404.  
  405.               arc x dogs  h:animals:cats:cat*.*
  406.               -- extract all "cat" files to the folder "animals:cats:".
  407.  
  408.  
  409.       Modifiers to the extraction command include the unGarble option 
  410.       to extract from an encrypted archive, as per
  411.  
  412.               arc xgMyPassword bob
  413.               -- extract all files from the archive "bob.arc" using 
  414.       password "MyPassword".  
  415.  
  416.       The I, strip IBM controls option is active for extraction.  Use 
  417.       this option if the files you are extracting are text files from 
  418.       an archive created on an IBM or MS-DOS machine.  All control 
  419.       characters other than the carriage return (ASCII 13) will be 
  420.       removed from all extracted files.  The List or VerboseList 
  421.       command will show file types as "ibm" if they come from an MS-DOS 
  422.       archive.  However, ArcMac cannot distinguish MS-DOS text from 
  423.       other MS-DOS file types.  You can specify a list of files that 
  424.       you believe are text when extracting, as per
  425.  
  426.               arc xi ibmdata  *.txt
  427.               -- this will extract and strip controls from all files 
  428.       ending with ".txt" in the archive "ibmdata.arc".  
  429.  
  430.  
  431.       P, Print archived files
  432.  
  433.       The print command writes the contents of archived files to the 
  434.       standard output device.  This is like extraction, but no file is 
  435.       created (unless output is redirected to a file).  The default 
  436.       output device is your display screen, so that you see the 
  437.       contents.  Alternately, use the output redirection command to 
  438.       send a Printed file to your printer or terminal or disk file.  
  439.       Examples are
  440.  
  441.               arc p myarc *.*
  442.               -- display contents of all files in "myarc"
  443.  
  444.               arc pi ibmdata *.txt > oneFileOfTxt
  445.               -- print contents of all files ending in ".txt" from the 
  446.       archive "ibmdata.arc", while stripping ibm controls, and send it 
  447.       all to the disk file "oneFileOfTxt".
  448.  
  449.               arc p dogs cat*.* > prn
  450.               -- write the contents of all "cat..." files to the 
  451.       printer.
  452.  
  453.  
  454.  
  455.  
  456.  
  457.        ArcMac  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  22
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.       T, Test archive integrity
  467.  
  468.       This command checks the validity of archive contents, and reports 
  469.       any files whose contents fail to match their CRC check value.  
  470.       Use this if archives are transmitted over noisy phone lines and 
  471.       you think the transfer may have been faulty.
  472.  
  473.  
  474.       C, Convert archive to new packing
  475.  
  476.       This command converts archives produced with older versions of 
  477.       IBM/MS-DOS archivers to newer packing methods, and will add the 
  478.       additional ArcMac information lacking in IBM archives.  Also this 
  479.       will convert archives produced by ArcMac version 1.0 to tighter 
  480.       packing schemes employed by version 1.1.
  481.  
  482.  
  483.  
  484.       Mouse Arc Dialog
  485.       ----------------
  486.  
  487.       ArcMac contains a useful Macintosh dialog, "Arc Dialog" found 
  488.       under the "Mouse" menu entry.  This dialog lets you set up the 
  489.       archiving command line by clicking buttons.  One of the arc 
  490.       commands can be selected from the list of radio buttons.  The 
  491.       major command modifiers have check boxes to enable them.  You can 
  492.       type the name of an archive to operate on, or use the <<Standard 
  493.       Arc Dialog>> button to pull up the standard Macintosh file 
  494.       selector for ArcMac archives.  You can use the <<Standard File 
  495.       Dialog>> button to repeatedly select files to add to an archive, 
  496.       or type the pathnames in the edit box.  Hitting the Return key or 
  497.       the <Okay> button will process the command sequence that you have 
  498.       selected; the <Cancel> button will cancel things.  
  499.  
  500.  
  501.  
  502.       Memory Requirements
  503.       -------------------
  504.  
  505.       ArcMac uses up to 250 kilobytes of memory for optimal processing 
  506.       speed during the archive Add operations.  The "squash" method 
  507.       alone requires over 64k of buffer space.  However, if memory is 
  508.       limited, ArcMac will analyze files for best packing by 
  509.       sequentially trying the Crunch, Squash and Squeeze methods, 
  510.       rather than the faster simultaneous analysis.  You can use the 
  511.       Finder menu selection, Get Info, to change the memory devoted to 
  512.       ArcMac under MultiFinder.
  513.  
  514.          Memory     Limitation
  515.          180 K   -- sequential analysis, squash is not permitted
  516.          220 K   -- sequential analysis, squash permitted
  517.          250 K   -- full simultaneous analysis during Add
  518.                    
  519.  
  520.  
  521.  
  522.  
  523.        ArcMac  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  23
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.       ArcPop Usage
  533.       ------------
  534.  
  535.       ArcPop is a small and simple de-archiving application.  In the 
  536.       ArcMac.Arc distribution archive, ArcPop is the application which 
  537.       extracts the archived material.  You can separate ArcPop from the
  538.       ArcMac.Arc archive by choosing the "Unmake ArcPop" button when 
  539.       you launch  ArcMac.Arc.  Version 1.1 adds support for "squashed" 
  540.       packing of PKArc and ArcMac.
  541.  
  542.       ArcPop's choices are limited to
  543.  
  544.            (1) extract all the files in an archive 
  545.            (2) make an archive into a ArcPop self-extracting archive 
  546.            (3) unmake a ArcPop-archive combination.
  547.  
  548.       You can launch ArcPop alone, then select an archive name on the 
  549.       dialog.  Version 1.1 adds a standard file get button, the <<Get 
  550.       Archive:>> button.  Use this to let your mouse do the walking 
  551.       through folders to select an archive to unpack.  All files in the 
  552.       archive are unpacked to the current folder; the file name 
  553.       and an indicator bar show the progress of unpacking.
  554.  
  555.       You can also shift-select ArcPop and a regular ArcMac archive, or 
  556.       an IBM style archive, from Finder and then launch ArcPop.  In
  557.       this case the selected archive will be your default to operate 
  558.       on.  If ArcPop already contains an archive in its data fork, the 
  559.       name of the ArcPop file will be the default archive to operate 
  560.       on.  
  561.  
  562.       Creating a ArcPop from a regular ArcMac archive is simple.  
  563.       Launch ArcPop and select the name of the archive to make self-
  564.       extracting.  Click the Make ArcPop radio button.  Click continue.  
  565.       ArcPop copies itself to the resource fork of the archive, making 
  566.       it an application.  ArcPop adds about 20 kilobytes to the size of 
  567.       an archive.  This makes it unwise to turn all archives that are 
  568.       to be placed on bulletin boards into ArcPops.  However, when you 
  569.       want to send archives to others that are unlikely to have an 
  570.       archive extractor, or want to pack a lot of data onto a disk and 
  571.       retain extracting ability on the disk, ArcPop is a useful tool.
  572.  
  573.       Two modifiers for ArcPop are the G, unGarble option for encrypted 
  574.       archives, and the I, strip IBM controls option.
  575.  
  576.       If the archive has been encrypted, you will need to enter the
  577.       proper password (either upper or lower case will do), and click 
  578.       the Password check box.  
  579.  
  580.       If the archive is from an MS-DOS or IBM machine, and contains 
  581.       text files, then you will want to click the eat linefeeds check 
  582.       box.  All control characters other than carriage returns will be 
  583.       removed from the extracted files.  If an IBM archive contains a 
  584.       mixture of text and other data files, you will need to use ArcMac 
  585.       to selectively extract files with control stripping.
  586.  
  587.  
  588.  
  589.        ArcMac  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  24
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.       There is a minor glitch in Finder running under MultiFinder 
  601.       (Apple System 5.0 release) that causes updates of a file's finder 
  602.       information not to be reflected in an open Finder window.  When
  603.       you make an ArcMac archive into an ArcPop self-extracting 
  604.       archive, the file's icon and its finder info does not get updated
  605.       in Finder's open window, even though it is updated on the disk.
  606.       What you need to do is simply to close the Finder window with the
  607.       new ArcPop archive, then re-open it.  Lo and behold, it's icon 
  608.       has now changed to the "A" button.
  609.  
  610.  
  611.  
  612.  
  613.  
  614.  
  615.  
  616.  
  617.  
  618.  
  619.  
  620.  
  621.  
  622.  
  623.  
  624.  
  625.  
  626.  
  627.  
  628.  
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.        ArcMac  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  25
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.  
  668.  
  669.       xArcMac Usage
  670.       -------------
  671.  
  672.       The ArcMac.Arc distribution file contains xArcMac.exe which is a 
  673.       program for MS-DOS machines that lists and extracts archives
  674.       created with ArcMac. xArcMac will also operate on MS-DOS 
  675.       archives, and most MS-DOS archivers will operate on ArcMac files.  
  676.       Command syntax is similar to that for ArcMac.  The commands L and 
  677.       V both produce a verbose list of an archive.  The E and X 
  678.       commands will extract files.  The Gpassword modifier is 
  679.       supported.  Version 1.1 of xArcMac adds support for processing 
  680.       "squashed" files of PKarc and ArcMac.
  681.  
  682.       Two additional features of xArcMac are 
  683.  
  684.               (1) The file listings which it produces include the full 
  685.       macintosh file name (ms-dos archivers recognize 12 characters 
  686.       only), and the mac file type. 
  687.        
  688.               (2) The I option is implemented in reverse.  When 
  689.       extracting WITHOUT the I option, all macintosh TEXT type files 
  690.       will have linefeed controls (^J) added after each carriage 
  691.       return.  Such line feeds are required by ms-dos text using 
  692.       programs.  If you do not want TEXT files to have the linefeeds 
  693.       added, then use the I option.
  694.  
  695.               xArcMac x mytext
  696.               -- extracts and adds linefeeds to TEXT type files
  697.  
  698.               xArcMac xi mytext
  699.               -- extracts without adding linefeeds
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.  
  724.  
  725.  
  726.        ArcMac  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  26
  727.  
  728.  
  729.  
  730.  
  731.  
  732.  
  733.  
  734.  
  735.       ArcMac File Structure
  736.       ---------------------
  737.  
  738.       ArcMac archives use a superset of SEA's ARC standard.  The full 
  739.       pascal source for ArcPop and xArcMac are available in the 
  740.       MARCS.ARC distribution archive.  The archive structure is defined 
  741.       as a file header followed by the (packed) file contents for each 
  742.       file in an archive.  Version 1.1 adds support for the "squash" 
  743.       method of PKArc, header version 9.  The file header is
  744.  
  745.       CONST
  746.           ARCMARK    = 26;    { standard ARC archive head marker }
  747.           MARCMARK   = 27;    { ArcMac archive head marker }
  748.           ARCFNLEN    =13;    { ARC file name length }
  749.           MARCFNLEN   =31;    { full mac file name length }
  750.       TYPE
  751.           cstr31  =  PACKED ARRAY [0..31] OF char; 
  752.                      { c-type nul terminated string }
  753.           fntype  = PACKED ARRAY [-1..12] OF char;
  754.                      { pc file name, starts at -1 to pack on word 
  755.                      bounds, name starts at 0 }
  756.           osType = PACKED ARRAY [1..4] OF char;
  757.           finfo  = PACKED RECORD {finder info}
  758.                     fdType   : OStype; fdCreator: OStype;
  759.                     fdFlags  : integer; fdLocation: longint;
  760.                     fdFldr   : integer;
  761.                     END;
  762.  
  763.           heads   = PACKED RECORD {file header structure}
  764.                                   {< MARCMARK mark byte comes here}
  765.                                   {< hdrVer header version byte comes here}
  766.               fullname: cstr31;  { full mac file name}
  767.               fndrInfo: fInfo;   { mac finder info}
  768.               f0length: longint; {! unarced data fork size }
  769.               f1length: longint; {! unarced rez fork size }
  770.               fill1  : byte;     { fill for word packing...also internal 
  771.                                    flag for ibm style head}
  772.               pcmark : byte;    { ARCMARK for standard pc arc}
  773.                                 {< hdrVer is name[-1] here, standard pc arc}
  774.              { vvvv standard pc arc heads vvvv}
  775.               name   : fntype;  { file name, standarc pc arc}
  776.               size   : longInt; {! archived size, both forks}
  777.               date   : integer; {! ms-dos style date}
  778.               time   : integer; {! ms-dos style time}
  779.               crc    : integer; {! crc value }
  780.               length : longInt; {! unarchived size, both forks}
  781.               END; 
  782.       { *heads.size* bytes of file data follow, followed by next file's 
  783.          MARCMARK, hdrVer, then heads data }
  784.       {! Note: these values are all stored in archive using Intel 80xxx 
  785.          byte sex,  Motorola 68xxx byte sex is bassackwards from this.  
  786.          For internal processing on Macintosh, all integers must by byte 
  787.          swapped, and all longints word swapped. See ArcPop source. }
  788.  
  789.  
  790.  
  791.  
  792.        ArcMac  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  27
  793.  
  794.  
  795.  
  796.  
  797.  
  798.  
  799.  
  800.  
  801.       Revision Information
  802.       --------------------
  803.       Version 1.2b -- 8 Feb 88: file creator files extracted from IBM 
  804.                    archives is now 'ttxt' (TeachText) rather then 'TPAS' 
  805.                    (Turbo Pascal).  ArcMac.Doc split into 2 text files 
  806.                    with the TeachText creator.
  807.                    
  808.       Version 1.2  -- 7 Feb 88, corrects miscellaneous bugs:  control-C 
  809.                    during extract, print or test now works properly.
  810.                    Window creep between launches of ArcMac is no more.  
  811.                    The Q+H modifiers now work in conjunction to produce 
  812.                    SEA ARC compatible archives (no squashing).  REMark 
  813.                    command added for batch files.  ArcPop now will not 
  814.                    overwrite existing files of same name, and will 
  815.                    abort if it runs out of disk space during unpack.
  816.  
  817.       Version 1.1  -- 31 Jan 88, adds full archive / dearchive support 
  818.                    to ArcMac, ArcPop and xArcMac for the "squashing" 
  819.                    method of PKArc, plus significant improvements in 
  820.                    the Crunch method, with a yeild of up to 100% 
  821.                    improvement in packing size.  ArcMac packing is now 
  822.                    comparable to PKArc and Stuffit.  
  823.                      Minor speed improvements (the fast version is still 
  824.                    waiting).  With large memory requirements of 
  825.                    squashing, have added memory usage controls so that 
  826.                    full, sequential analysis can be done in limited 
  827.                    memory environs.  MOS user window setup is now saved 
  828.                    between runs.  ArcMac start-up batch file processing 
  829.                    added.  ArcPop standard file get button and progress 
  830.                    indicator added.
  831.  
  832.       Version 1.0  -- first release, 23 Jan 88
  833.  
  834.  
  835.  
  836.  
  837.  
  838.  
  839.  
  840.  
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.  
  856.  
  857.  
  858.  
  859.        ArcMac  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  28
  860.  
  861.  
  862.  
  863.  
  864.  
  865.  
  866.  
  867.  
  868.         Martian Operating System for the Macintosh
  869.         ------------------------------------------
  870.  
  871.         MOS is an operating system shell for the Macintosh, patterned   
  872.         after MS-DOS.  MOS (short for Martian Operating System) is an 
  873.         obvious alien to the Mac, since it is a complete keyboard and 
  874.         text oriented system.  
  875.  
  876.         MOS contains all of the features of MS-DOS, including a text 
  877.         display, keyboard commands, command line program operation, 
  878.         file, disk and serial device (printer, comm ports) operations, 
  879.         hard disk path search and file wild card naming, versions of 
  880.         ARC, DEBUG, PRINT, and other such utilities, i/o redirection, 
  881.         batch file operation, as well as easy Mac-PC file transfer via 
  882.         serial ports.
  883.  
  884.         Programmers, take note:  MOS also serves as an easy I/O
  885.         platform for running independent programs that don't require a 
  886.         graphic interface and utilities that work well from command 
  887.         line parameters.
  888.  
  889.         MOS is not for all Mac users, but those who have familiarity 
  890.         with MS-DOS, those who like keyboard based commands, batch 
  891.         operations, redirectable text input/output, and similar 
  892.         features.
  893.           
  894.         Available in Spring 1988 from dogStar Software.  
  895.  
  896.  
  897.       Trademarks & Copyrights mentioned
  898.       ---------------------------------
  899.       Macintosh computer, Finder, MultiFinder and related software are  
  900.       trademarked, copyrighted and otherwise legally pinned down by 
  901.       Apple Computer, Inc.
  902.  
  903.       ARC is the copyrighted software of System Enhancement Associates.
  904.  
  905.       PKARC, PKXARC are the copyrighted software of PKWare (Phil Katz).
  906.  
  907.       MS-DOS is a registered trademark of Microsoft Corporation.
  908.  
  909.       IBM is a register trademark of International Business Machine 
  910.       Corporation.
  911.  
  912.       Turbo Pascal is the registered trademark of Borland 
  913.       International.
  914.  
  915.       Packit is the copyrighted software of Harry Chesley.
  916.  
  917.       Stuffit is the copyrighted software of Raymond Lau.
  918.  
  919.       Martian Operating System, ArcMac, ArcPop, and xArcMac are the 
  920.       copyrighted software of D.G. Gilbert (dogStar Software).
  921.  
  922.  
  923.  
  924.  
  925.        ArcMac  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  29
  926.  
  927.  
  928.  
  929.  
  930.  
  931.  
  932.  
  933.  
  934.                              ArcMac Fee Schedule 
  935.  
  936.       Type                                    Price
  937.       -------                                 ------
  938.  
  939.       1. Single ArcMac user fee                  $25
  940.  
  941.         -- includes a $25 discount toward the purchase of Martian 
  942.            Operating System.
  943.  
  944.  
  945.       2. Registered ArcMac user fee              $40
  946.  
  947.         -- includes the next major revision of ArcMac with printed manual,
  948.            and a $40 discount applicable to purchase of Martian 
  949.            Operating System.
  950.  
  951.  
  952.       3. Corporate & Institution site licences
  953.  
  954.         -- includes the next major revision of ArcMac with printed 
  955.            manual.
  956.  
  957.            2 to 5 computers                    $25 / computer
  958.            6 to 20 computers                   $20 / computer
  959.            21 to 50 computers                  $17.50 / computer
  960.            51 to 99 computers                  $15 / computer             
  961.            100+ computers                      $1500 
  962.  
  963.  
  964.  
  965.  
  966.  
  967.  
  968.  
  969.  
  970.  
  971.  
  972.  
  973.  
  974.  
  975.  
  976.  
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.  
  987.  
  988.  
  989.  
  990.  
  991.  
  992.  
  993.        ArcMac  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  30
  994.  
  995.  
  996.  
  997.  
  998.  
  999.  
  1000.  
  1001.  
  1002.                          ArcMac Invoice / Order Form 
  1003.  
  1004.       Title                                   Price   Copies
  1005.       -------                                 ------  ------
  1006.  
  1007.  
  1008.       ArcMac                                   _____   ____
  1009.  
  1010.       _______________________________________________________
  1011.  
  1012.                                       Total Fee     _______
  1013.  
  1014.       SHIPPING ADDRESS
  1015.  
  1016.       Name    ____________________________________________
  1017.  
  1018.       Address ____________________________________________
  1019.  
  1020.               ____________________________________________
  1021.  
  1022.       City    ____________________ State ____  Zip _______
  1023.  
  1024.       Country ____________________ Phone _______________
  1025.  
  1026.  
  1027.       Payment:
  1028.  
  1029.       __ Check or money order 
  1030.  
  1031.       Credit Card Acct. No.   __ Visa   __ MasterCard
  1032.  
  1033.       :__:__:__:__::__:__:__:__::__:__:__:__::__:__:__:__:
  1034.  
  1035.       MasterCard Bank # (found over name) :__:__:__:__:
  1036.  
  1037.       Exp. date ____ Signature _____________________________
  1038.  
  1039.       Purchase orders from established government and educa-
  1040.       tional institutions are accepted.
  1041.  
  1042.       __ Purchase Order #______________
  1043.  
  1044.           PO institution ____________________________
  1045.  
  1046.  
  1047.       Prices include shipping via First Class US Post within
  1048.       the North American continent and USPS delivery areas.
  1049.       Add $1.50 for United Parcel Service shipping.  Overseas
  1050.       airmail:  Europe and South America, add $2.50.  Asia,
  1051.       Africa and Australia, add $3.50.
  1052.  
  1053.                           dogStar Software
  1054.           P.O. Box 302, Bloomington, Indiana 47402, U.S.A.
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.        ArcMac  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  31
  1061.  
  1062.  
  1063.  
  1064.  
  1065.  
  1066.